.. _cmlPmSxGetTargetPos:

cmlPmSxGetTargetPos
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

  VT_I4 cmlPmSxGetTargetPos([in] VT_I4 BoardID,  [in] VT_I4 NodeId, [in] VT_I4 Channel, [out] VT_PR8 Position )  

DESCRIPTION
`````````````  

- 대상 축에 대하여 마지막으로 수행한 이송 명령의 위치(상대 or 절대 좌표)를 반환합니다. 대상 함수는 
  cmlPmSxMove, cmlPmSxMoveStart, cmlPmSxMoveTo, cmlPmSxMoveToStart  입니다.  

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.

PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NodeId : 사용자가 제어하고자 하는 노드 번호.
 
▶ Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 
통합 축 개수 - 1 이하의 값을 축 번호로 설정할 수 있습니다. 
 
▶ Position : 대상 축에 대하여 마지막으로 이송한 (상대 혹은 절대 좌표) 위치를 반환합니다. 


RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+

EXAMPLE
`````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

  C/C++ 
  
  #include “ComiMLink2_SDK.h” 
  #include “ComiMLink2_SDK_Def.h” 
  
  long BoardID = 0; 
  long nChannel = 0; //0번 축으로 설정합니다. 
  //0번 축을 현재 위치에서 1000만큼 이송합니다.
  cmlPmSxMove(BoardID, 0, nChannel, 1000, cmlFALSE ); 
  double fPosition = 0.0f; 
  //0번 축이 마지막으로 이송한 위치를 반환합니다. 
  cmlPmSxGetTargetPos(BoardID, 0, nChannel, &fPosition );